From e725c73ba0aee2040e5199394f70894ca25cd62c Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 5 Jan 2009 04:19:48 +0000 Subject: [PATCH] Add long description svn path=/trunk/; revision=22063 --- docs/reference/ChangeLog | 7 +++++++ docs/reference/gtk/tmpl/gtkviewport.sgml | 14 +++++++++++++- 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 1f9ada35f0..d6c5b6bdde 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,10 @@ +2009-01-04 Matthias Clasen + + Bug 566045 – GtkViewport is lacking a description + + * gtk/tmpl/gtkviewport.sgml: Add some descriptive text, shamelessly + copied from gtkscrolledwindow.sgml. Requested by Andrew Cowie. + 2009-01-01 Matthias Clasen * === Released 2.15.0 === diff --git a/docs/reference/gtk/tmpl/gtkviewport.sgml b/docs/reference/gtk/tmpl/gtkviewport.sgml index 54eefc0e60..c6343cb8e0 100644 --- a/docs/reference/gtk/tmpl/gtkviewport.sgml +++ b/docs/reference/gtk/tmpl/gtkviewport.sgml @@ -6,12 +6,24 @@ An adapter which makes widgets scrollable +The #GtkViewport widget acts as an adaptor class, implementing +scrollability for child widgets that lack their own scrolling +capabilities. Use #GtkViewport to scroll child widgets such as +#GtkTable, #GtkBox, and so on. + + +If a widget has native scrolling abilities, such as #GtkTextView, +#GtkTreeView or #GtkIconview, it can be added to a #GtkScrolledWindow +with gtk_container_add(). If a widget does not, you must first add the +widget to a #GtkViewport, then add the viewport to the scrolled window. +The convenience function gtk_scrolled_window_add_with_viewport() does +exactly this, so you can ignore the presence of the viewport. - +#GtkScrolledWindow, #GtkAdjustment -- 2.30.2